home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / suprig40.zip / SUPERIG.DOC < prev    next >
Text File  |  1991-03-05  |  46KB  |  1,100 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │              SUPER Rig! V4.01k             │
  17.                  │            ********************            │
  18.                  │                                            │
  19.                  │      Live BBS Game for Wildcat!, RBBS,     │
  20.                  │ QuickBBS, GAP, GTPower's, Phoenix & others │
  21.                  │          Version Release 01-01-91          │
  22.                  │                                            │
  23.                  │            (C)opyright 1989-91             │
  24.                  │                                            │
  25.                  │                   -By-                     │
  26.                  │                                            │
  27.                  │             Late Nite Software             │
  28.                  │                                            │
  29.                  │                Marvin Davis                │
  30.                  │              313 Queens Road               │
  31.                  │             Sanford, NC 27330              │
  32.                  │                                            │
  33.                  │       Late-Nite BBS (919) 776-2368         │
  34.                  │     USR Dual Standard V.42/32, V.22bis     │
  35.                  │    14400/9600/4800/2400/1200/300 24 hrs    │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  └────────────────────────────────────────────┘
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                          Super Rig! (C)opyright 1989-91
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                        T A B L E   O F   C O N T E N T S 
  68.                        ---------------------------------
  69.  
  70.  
  71.  
  72.  
  73.   Warranty, Disclaimer ......................................... page 1
  74.   
  75.   Registration ................................................. page 1
  76.  
  77.   Zip contents, tech support number............................. page 2
  78.  
  79.   Game descriptions & features.................................. page 3
  80.  
  81.   WildCat! Setup................................................ page 4
  82.  
  83.   RBBS/QuickBBS Setup........................................... page 4
  84.  
  85.   GAP & GTPower Setup........................................... page 4
  86.  
  87.   Phoenix Setup................................................. page 4
  88.  
  89.   PCBoard setup................................................. page 5 
  90.  
  91.   MULTI-NODE BBS setups......................................... page 5
  92.  
  93.   GENERIC BBS setup from batchfile.............................. page 6
  94.  
  95.   Keyboard or LOCAL play........................................ page 7
  96.  
  97.   Line 25 (Game Status Line).................................... page 7
  98.  
  99.   Wildcat batchfile example..................................... page 7
  100.  
  101.   RBBS Door batchfile example................................... page 8
  102.  
  103.   Installation Tips............................................. page 9
  104.  
  105.   New ".KEY" file auto registration............................. page 10
  106.  
  107.   Trouble and communications of;................................ Appendix A
  108.  
  109.   Trouble with ANSI graphics.................................... Appendix B
  110.  
  111.   Registration mail in form..................................... Appendix C
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                        Super Rig!  (C)opyright 1989-91
  123.  
  124.  
  125.  
  126.   Warranty
  127.   ========
  128.  
  129.   This is product is provided  "as is" without warranty of  any kind.  The 
  130.   entire risk as to the results  and program performance is assumed by you.  
  131.   Also, in addition, I the author  do not warrant, guarantee, or make  any  
  132.   representations regarding the use  of, or the results of the use of  the  
  133.   program and you rely on the program  and results solely at your own risk.  
  134.   The author cannot accept responsibility  for system damage, profit  loss, 
  135.   or any other special, incidental or consequential damages resulting from
  136.   the use, misuse or inability to use this product. If you understand this,
  137.   then please proceed.
  138.  
  139.  
  140.   Copyright
  141.   ---------
  142.  
  143.   The 'Super Rig!' live game is distributed as SHAREWARE. Under this concept 
  144.   you may use a SHAREWARE (unregistered) version for a reasonable period  of
  145.   time, which I CONSIDER TO BE 30 DAYS, after which you MUST either register 
  146.   your copy or DISCONTINUE usage altogether!
  147.  
  148.  
  149.   Registration
  150.   ------------
  151.  
  152.   With registration you will receive the latest registered copy  of  Super 
  153.   Rig! with the ability to download any futher updates from The  Late-Nite 
  154.   BBS! at no extra cost.  You will also receive any support the author can 
  155.   give in reference to bugs or other problems that may arise in  using the 
  156.   game.  I feel that sysop's have enough expense without charging  a  high 
  157.   cost for games for their users. I have set the cost of  registration  at 
  158.   $13.00  (for a single node version, and 15.00 for a Multi-Node version).
  159.   I feel that if people follow the shareware concept, it will be enough to 
  160.   cover shipping, disk mailer and handling. Plus this will encourage me to 
  161.   write more BBS doors!
  162.  
  163.   ** SEE REGISTRATION FORM in this ZIP archive for ordering instructions **
  164.  
  165.   When registered, the Doorware message and DELAY will not be  present.  Do
  166.   not attempt to delete or alter the Doorware message as the game will  now
  167.   cease to function entirely.  It is most unfortunate that I was FORCED  to
  168.   resort to an annoy screen BUT - with less than 5% registrations coming in
  169.   there was no choice left.  Shareware is NOT FREE software.  Shareware  is
  170.   a system by which authors deal with users directly and no marketing  type
  171.   middle-men are needed.  This is where 75-85% of the cost of  software  is
  172.   generated!
  173.  
  174.  
  175.   Distribution
  176.   ------------
  177.  
  178.   You are free, in fact encouraged, to distribute a SHAREWARE (unregistered)
  179.   version of Super Rig! live game, provided that all files contained in the 
  180.   ORIGINAL Super Rig! archive are distributed in the absolute ORIGINAL form.
  181.  
  182.  
  183.                      Super Rig!  (C)opyright 1989-91, Page 1
  184.  
  185. CONTENTS of the .ZIP archive file:
  186.   
  187.   These files are found in your Zip or will be created during the runtime;
  188.   ---------------------------------------------------------------------------
  189.   README        ;read this first!  Startup Info...
  190.   COPDAY   ASC  ;files than have a .ASC extension are MONOchrome data files.
  191.   DAY0     ASC  ;
  192.   DAY1     ASC  ;
  193.   NEWYORK  ASC  ;
  194.   SUPERIG  ASC  ;
  195.   TRUKSTOP ASC  ;
  196.   DOOR35   BAT  ;>sample BBS batch file example
  197.   SUPERIG  CFG  ;GAME configuration - setup file.
  198. * SUPERIG  DAT  ;game score datafile
  199.   SUPRHLP  SCR  ;Color game instruction screen
  200.   SUPERIG  DOC  ;GAME DOCUMENTATION - Print it out and read it!
  201.   SETUP    EXE  ;Setup program for game, just run.
  202.   SUPERIG  EXE  ;Super Rig! Game 
  203.   REGISTER FRM  ;Form to mail in your registration.
  204.   COPDAY   SCR  ;files that have .SCR extension are ANSI color data files.
  205.   COPNITE  SCR  ;
  206.   DAY0     SCR  ;
  207.   DAY1     SCR  ;
  208.   DAY2     SCR  ;
  209.   DAY3     SCR  ;
  210.   DAY4     SCR  ;
  211.   DAY5     SCR  ;                      [ANSI data files]
  212.   DAY6     SCR  ;
  213.   DAY7     SCR  ;
  214.   NEWYORK  SCR  ;
  215.   NITE1    SCR  ;
  216.   SUPERIG  SCR  ;
  217.   TITLE    SCR  ;
  218.   TRUKSTOP SCR  ;
  219.   SUPRHLP  ASC  ;MONOchrome game instructions screen.
  220. * SUPERIG  ERR  ;(logs runtime errors)
  221.   DOORWARE ASC  ;Doorware announcement - WARNING, DO NOT DELETE OR EDIT!
  222.   CRASH    SCR  ;Color users only crash screen
  223. * SCORBORD SCR  ;Top 10 Color scoreboard
  224. * SCORBORD ASC  ;Top 10 Mono scoreboard
  225. * BULL#    BBS  ;MONO bulletin  (auto TOP TEN) Path in SUPERIG.CFG
  226. * BULL#    SCR  ;COLOR bulletin (auto TOP TEN) Path in SUPERIG.CFG
  227. ------------------------------------------------------------------------------
  228. * DENOTES that file is updated/created during RUN-TIME.
  229.  
  230.  Registered Users Technical Support:
  231.  -----------------------------------
  232.  If you have problems with Super RIG!, you may contact Marvin Davis at 
  233.  Late-Nite BBS! 24 hrs. Node-1 (919) 776-2368  14400/9600/2400 USR-DS V42/32
  234.                         Node-2 (919) 775-4477   2400/1200/300  MNP
  235.  
  236.  Registration/ Order Information:
  237.  --------------------------------
  238.  Please refer to the REGISTER.FRM file included on this  disk  to  register
  239.  your Late-Nite games with me.  A quick and easy form is  ready to fill out
  240.  and mail.  Registered users are entitled to FREE updates to any registered
  241.  Late-Nite BBS game.  You can download them directly from  the BBS Doorware 
  242.  download section on Late-Nite BBS.
  243.  
  244.                      Super Rig! (C)opyright 1989-91,  Page 2
  245.  
  246.  
  247.                                 -Super Rig!-
  248.                          (C) 1989-91 Marvin Davis
  249.  
  250.  Super Rig is a new game.  It takes off where a simular game named "Big Rig"
  251.  leaves you.  Those of you who've played "Big-Rig" will enjoy this game much 
  252.  more, as more is included.  Watch your speed, route and cargo carefully and 
  253.  make the most out of stops at the 'Greasy Spoon'  Truck Stop!  Watchout for 
  254.  the Waitress's and Mechanic's.  They can either help you or hurt you!
  255.    
  256.  This game supports both MONOchrome and ANSI Color graphics modes. COM ports
  257.  COM1-COM4, game exit on Carrier loss, and complete keyboard control  during 
  258.  runtime.  Game is configured by the configuration file below.  Support  for 
  259.  several popular BBS programs, WildCat!, RBBS, QBBS, GAP and PCBoard  are  a
  260.  few to name.  Also, a command line 'generic' setup for use  with  basically 
  261.  any BBS program that can pass DOS variables to a batch file.  The  game has
  262.  a "dead time" of two minutes at any prompt and the game is terminated.
  263.  
  264.  The following ASCII configuration file is commented so that it  can easily 
  265.  edited to comform to your BBS.  The file must be in this form to correctly 
  266.  pass important parameters to the game.  You may RUN the SETUP.EXE  program 
  267.  to assist in writing this file - which is recommended for first time users.
  268.  All the text to the right of the ";" semicolons are just remarks. 
  269.  
  270.  SUPERIG.CFG                     ;game config file  
  271.  -----------------------------------------------------------------------------
  272.  Starvin' Marv's                 ;Your BBS's name
  273.  Marvin                          ;Sysops first name
  274.  Davis                           ;Sysops last name
  275.  C:\BBS\CALLINFO.BBS             ;BBS caller file supported (see list)
  276.  C:\BBS\BULLETS\BULL#22.BBS      ;PATH for Text bulletin       
  277.  C:\BBS\BULLETS\BULL#22.SCR      ;PATH for ANSI Color Bulletin
  278.  N/A                             ;Locked DTE baud rate "LOCKED {baud} RTS/CTS"
  279.  N/A                             ;or Printer Logging ports [LPT1-3]
  280.  NONE                            ;or REGISTERED Name
  281.  00000                           ;or game SERIAL number.
  282.  
  283. *( NOTE )*  HST users will need to add a hardware handshake to the LOCKED
  284.             DTE baud with letters "RTS/CTS" after LOCKED {baud}, so line #7
  285.             should read for DTE 19200 this;  LOCKED 19200 RTS/CTS
  286.  
  287. BULLETINS
  288. ---------
  289.  On game completion, automatic TOP TEN Bulletins, both MONOCHROME  and  COLOR 
  290.  will be created to the PATH/FILESPEC designated.  If a user aborts the  game
  291.  at a speed prompt with 'Q', then the game is exited and no bulletin created.
  292.  If NO BULLETINS ARE WISHED, or no color bulletin is supported, then place  a 
  293.  N/A in line #6, where the PATH parameters/filespec is!
  294.  
  295. PRINTER LOG
  296. -----------
  297.  If a printer is being used to keep a running log of callers, errors, etc.,
  298.  then you can place in upper case the word LOG instead of the word  N/A in 
  299.  (line #6) above config file.  Game minutes, start time and end  time  are 
  300.  printed on the printer  connected to printer  port 1  (LPT1).  Also,  any 
  301.  untrapped errors  are  recorded  and  are  useful in isolating a problem.
  302.  
  303.  
  304.                      Super Rig! (C)opyright 1989-91,  Page 3
  305.  
  306.                    
  307. Command Line parameter syntax:
  308. ------------------------------
  309.  
  310. SUPERIG {space} /game switch(s)
  311.  
  312. WILDCAT! V2.xx      -> Caller info file = CALLINFO.BBS
  313. --------------
  314.  SUPERIG /WC        ;the ' /WC' parameter instructs the game to run under
  315.                     ;WildCat! and get its user info from the CALLINFO.BBS
  316.                     ;file that WildCat! produces when running a door.
  317.                     ;CALLINFO.BBS path and filespec are configured in the
  318.                     ;SUPERIG.CFG file line # 4.
  319.  
  320.  
  321. RBBS V17.xx or QBBS -> Caller info file = DORINFOx.DEF 
  322. -------------------
  323. SUPERIG /RBBS       ;the ' /RBBS' parameter instructs the game to run under
  324.      or             ;RBBS and to get its user info from the DORINFOx.DEF
  325. SUPERIG /QBBS       ;file, where 'x' is the node number. For a single line
  326.                     ;board x = 1 and the infor file would be DORINFO1.DEF
  327.                     ;DORINFO1.DEF path and filespec are configured in the
  328.                     ;SUPERIG.CFG file line # 4.
  329.  
  330.  QuickBBS users whose BBS software writes the DORINFO1.DEF file can use the
  331.  /RBBS command line switch to inform the game that it is to get its caller 
  332.  information from the same compatible file DORINFO1.DEF.  So QuickBBS users
  333.  can use the RBBS setup for their board software.  If you wish to run port 
  334.  locked DTE then set that spec in the SUPERIG.CFG file and it will ignore 
  335.  any baud rate in the DORINFO1.DEF file.
  336.  
  337. GAP BBS             -> Caller info file = DOOR.SYS
  338. -------
  339.  SUPERIG /GAP       ;Set game for GAP and read in DOOR.SYS as it caller
  340.                     ;file.  filename entered on line #4 of SUPERIG.CFG.
  341.                     ;If you are a GAP user and wish locked port DTE baud
  342.                     ;then RUN SETUP.EXE or enter LOCKED {baud} on line # 7
  343.                     ;of SUPERIG.CFG file.
  344.  
  345. GTPOWER             -> Caller info file = GTUSER.BBS
  346. -------
  347.  SUPERIG /GTP       ;Sets game for GTPower and read in GTUSER.BBS caller file
  348.                     ;for caller infor.  Since this BBS's caller file does NOT
  349.                     ;contain current COM PORT configuration you may need an 
  350.                     ;additional switch to set the game COM port up.  EXAMPLE;
  351.                     ;SUPERIG /GTP/2 ;sets game for COM2: from DEFAULT of COM1
  352.                     ;so, If using COM1 ignore the "/2" switch parameter.
  353.  
  354. PHOENIX V1.x        -> Caller info file = INFO.BBS
  355. ------------
  356.  SUPERIG /PHX       ;Sets game for PHOENIX and read in INFO.BBS for caller
  357.                     ;info.  Game will get it baud speed from this file and if
  358.                     ;you are a HST user - use the SUPERIG.CFG file to setup a
  359.                     ;LOCKED port of 19200 or 34400 baud to ignore the caller
  360.                     ;DCE baud rates.  This can be done in SETUP as well.
  361.  
  362.  
  363.  
  364.  
  365.                      Super Rig! (C)opyright 1989-91,  Page 4
  366.  
  367.  
  368. PCBoard V14.x and up -> Caller info file = PCBoard.Sys
  369. --------------------
  370.  SUPERIG /PCB        ;the ' /PCB' parameter instructs the game to run under
  371.                      ;PCBoard and get its user info from the file called
  372.                      ;PCBOARD.SYS created by PCBoard to pass call information
  373.                      ;to another program via a simple text file.
  374.  
  375.  
  376. Multi-Node Setup config's:
  377. --------------------------
  378.  A switch setting is added to the command line for the Node that is calling 
  379.  up the game.  Place this after the command line switch for the BBS that is 
  380.  using the game.  An example below is set for WildCat on Node #1; 
  381.  
  382.  SUPERIG /WC /NODE1
  383.  
  384.  The following additional switch will cause  the game to read in a file in
  385.  the current game directory called  SUPERIG1.CFG instead of the normal BBS
  386.  configuration file called SUPERIG.CFG.  You may edit these files directly
  387.  in an ASCII editor, or use the SETUP.EXE file and fill in the prompts to
  388.  create them. 
  389.  
  390.  Up to 4 Nodes can have separate SUPERIGx.CFG (where x is the NODE number)
  391.  in the current game directory, and in this file you can point to the NODE
  392.  directory's caller file.  Below is a sample BATCHFILE that might call the
  393.  game from NODE 2 for instance called SUPERIG2.BAT;
  394.  
  395.  CD DOOR#3
  396.  SUPERIG /WC /NODE2
  397.  ECHO Game finished, returning to BBS
  398.  CD BBS
  399.  CAT
  400.  
  401.  The NODEx (where x is the NODE number) switch  will instruct  SUPERIG.EXE
  402.  to read a different game .CFG file when its invoked.   Note the  complete 
  403.  PATH to the caller file for the particular Node.  Example, a SUPERIG2.CFG 
  404.  file might contain the following data;
  405.  
  406.  Starvin' Marv's
  407.  Marvin
  408.  Davis
  409.  C:\BBS\NODE2\CALLINFO.BBS
  410.  C:\BULLETS\BULL#22.BBS
  411.  C:\BULLETS\BULL#22.SCR
  412.  N/A
  413.  N/A
  414.  
  415.  At present, four 'nodes' and COM ports are supported (ie. COM1-4) They're
  416.  normally assigned to their respective COMM ports, NODE1 to COM1 and NODE2 
  417.  to COM2.  The game will look in the caller file that is specified in  the 
  418.  SUPERIGx.CFG file, and the game will use the COM port specified for  that 
  419.  caller.  Under different 'node' configuration files, you could  have  two 
  420.  different scoreboard bulletins created, one for each node -  but the game 
  421.  will only have one scoreboard file in both ANSI and ASC format in its own 
  422.  door directory at the completion of a successful run by a  player.  These 
  423.  are always created on a good run even if the .CFG file lists  an  N/A for 
  424.  BBS bulletin scoreboard file creation.
  425.  
  426.                      Super Rig! (C)opyright 1989-91, Page 5
  427.  
  428.  
  429. GENERIC BBS
  430. -----------
  431.  SUPERIG /GEN        ;the ' /GEN' parameter instructs the game to look for 
  432.                      ;its basic configuration info on the command line!  
  433.                      ;You can set up the game to run on any BBS that can 
  434.                      ;pass parameters to %1, %2, %3 etc. DOS variables to
  435.                      ;your calling batchfile.
  436.                      ;Parameters shown below with parameters separated with
  437.                      ;a SPACE character.
  438.  
  439.  
  440.  SUPERIG /GEN COM1 n AN
  441.  
  442.                      ;where COM is either COM1 or COM2, where "n" is the
  443.                      ;specified baud rate below;
  444.     
  445.                        0 = 300
  446.                        1 = n/a   [NOTE: 1 is NOT USED!]
  447.                        2 = 1200
  448.                        3 = 2400
  449.                        4 = 4800
  450.                        5 = 9600
  451.                        6 = 19200
  452.  
  453.                      ;8 data bit, 1 stop bit and no parity are defaulted.
  454.  
  455.                      ;The AN instructs Super Rig to use ANSI color graphics
  456.                      ;and an AS instructs to use standard ASCII text.
  457.                      ;Without ANSI or ASCII specified, ASCII is defaulted.
  458.                      ;The following is an example of a 'generic' setup.
  459.  
  460.  
  461.  
  462. SUPERIG /GEN COM1 3 AN   -> sets PORT as COM1, speed as 2400 and also uses 
  463.                             ANSI COLOR graphics.
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                      Super Rig! (C)opyright 1989-90, Page 6
  488.  
  489.  
  490. KEYBOARD PLAY -or- LOCAL mode
  491. -----------------------------
  492.  SUPERIG /LOCAL      ;sets game to play on the keyboard, with no color.
  493.  SUPERIG /LOCAL/C    ;set game to play on keyboard and use COLOR graphics.
  494.                      ;NOTE, bulletins are NOT created in LOCAL keyboard mode.
  495.                      ;This a purely an evaluation mode for the SYSOP! 
  496.  
  497.  
  498. SETUP EXAMPLES
  499. --------------
  500.  Setting up The Super Rig! Game for WildCat! version 2.xx
  501.  Create your batch file to;
  502.     
  503.        1. call the game with file SUPERIG /WC
  504.        2. last line in batch file calls WILDCAT! back
  505.  
  506.  An "example" of a batch file from WildCat1 ver 2.xx, named DOOR35.BAT
  507.  might look like this;
  508.  
  509.  CD DOOR#xx
  510.  CD RIGGAME
  511.  SUPERIG /WC
  512.  CD \WILDCAT
  513.  CAT
  514.  
  515.  
  516.  ** Be VERY careful with PATH for files, it must be complete and correct! **
  517.  
  518.  
  519. Game STATUS LINE;
  520. -----------------
  521.  While running the game, the bottom  screen line (line # 25) will  be  the 
  522.  current Player Status Line.  The  Game name, players name, date, time  of 
  523.  game start, callers baud rate and current state of the print  'LOG'. This 
  524.  will let the SysOp know whether or not he or she has the program  logging 
  525.  to printer.  If the SysOp wishes to 'nuke' a player out of the game,  the 
  526.  ESC key is the kill key.  Once pressed the game is immediately terminated 
  527.  so be carefull on that as some keyboards (84 and 102) have the ESC key 
  528.  right next to the number 1 key!
  529.  
  530.  
  531. FOR REGISTERED USERS!!
  532. ----------------------
  533.  Extra features are allowed on the function keys.  At any prompt other than 
  534.  a "(Y/N?)" prompt, the "F1" key will toggle the bottom status line to show
  535.  the function key definitions.  F1, F5, F9 are displayed to  show  that you
  536.  have a [Drop to DOS] and a [Online Chat] mode!  You can chat with a caller
  537.  in the game and resume with F9 key which acts as a Chat modem toggle. Also
  538.  displayed is the "remaining players minutes".  Which is helpful if you see
  539.  that a player is about to run out of time.  Players will  be  warned  each
  540.  minute upon reaching five minutes of play left.  Remaining  minutes of the
  541.  call are read in on the BBS caller file if one is available  in the config
  542.  files for WildCat! and RBBS, so users aren't allowed to exceed their time.
  543.  
  544.  
  545.  
  546.  
  547.  
  548.                      Super Rig! (C)opyright 1989-91, Page 7
  549.  
  550.  
  551. RBBS sample batch file (door)
  552. -----------------------------
  553. RBBS example by Wayne Aiken, Sysop, StarFleet BBS, Raleigh NC  919-782-3095
  554.  
  555.   RBBS has the capability to call DOORs (by either) SHELLing out to DOS, or 
  556.   by quitting RBBS completely.  My system does the latter.  When RBBS quits 
  557.   to a DOOR, it dynamically builds a file called RCTTY.BAT.  This file is 
  558.   dynamically created, and contains the name of the next batch file in the 
  559.   sequence, the batch file that invokes the particular door:
  560.  
  561. ------------------------------- RBBS.BAT ------------------------------------
  562. echo off
  563.     cd \RBBS
  564.     if exist RBBS1F1.DEF del RBBS1F1.DEF
  565.     if exist RBBS1TM.DEF del RBBS1TM.DEF
  566.     if exist RCTTY.BAT   del RCTTY.BAT
  567.     WATCHDOG OFF
  568.     RBBS-PC
  569.     if exist RBBS1F1.DEF goto Exit
  570.     if exist RCTTY.BAT   RCTTY.BAT
  571.     if exist RBBS1TM.DEF RBBS1TM.BAT
  572.     E:\RBBS\RBBS.BAT
  573. :Exit
  574. -------------------------------- RBBS.BAT -----------------------------------
  575.  
  576. In the example above, the presence of the file RBBS1F1.DEF means that RBBS
  577. has been ordered to shut down, RCTTY.BAT means a DOOR will be executed, and
  578. RBBS1TM.DEF means that the daily event has been invoked.  All of these files
  579. are deleted when RBBS starts up, if it is recycled as in the case of a DOOR
  580. or scheduled event.
  581.  
  582. RCTTY.BAT contains the lines:
  583.  
  584.    G:\COMMAND /C xxxx 
  585.    E:\RBBS\RBBS.BAT
  586.  
  587. where xxxx is the name of the batch file for the Door.  This name must also
  588. appear in MENU5x, which is the Doors menu.
  589.  
  590. A sample batch file for the door, in this case the Superig door is:
  591.  
  592.    watchdog off
  593.    e:
  594.    cd \rbbs\game
  595.    superig /rbbs
  596.    cd \rbbs
  597.  
  598.  I set WATCHDOG off because the Superig door automatically monitors carrier
  599.  detect.  After the program terminates, I have it go back to the proper
  600.  directories.  When it quits, it falls back to RCTTY.BAT (/c parm), which
  601.  then invokes RBBS.  RBBS is a pretty big file to be re-loading each time, 
  602.  but I have it in a RAM disk so it does it fairly quickly.
  603.  
  604.  Some sysops may use the SHELLing method to do it.  In either case, this 
  605.  shouldn't affect your Doors programs, except possibly if this SHELLing makes
  606.  memory tight.  RBBS takes up about 384K of memory, which is why I use the
  607.  RUN method in the case that I got a DOOR which was also memory-hungry.
  608.  
  609.                      Super Rig!  (C)opyright 1989-91, Page 8
  610.  
  611.  
  612. Installation tips;
  613. ------------------
  614.  For those with slow hard drives, you can run this game from  a RamDisk to
  615.  save wear-and-tear on accessing.  Since color files are stored on disk as
  616.  files, the disk access is fairly constant.  I use a large 'disk cache' on
  617.  my BBS to speed up repeat accesses.  Once the game, color and data  files
  618.  are read once, those files are no longer  accessed  for  reading.  So you
  619.  might use a disk-cache or RamDisk to enhance your systems  speed  or save
  620.  some usage on your hard disk!  If all the files were hard coded  into the
  621.  game, it would be too large for  most  BBS's to  run,  especially  from a 
  622.  SHELL process.  If you have a printer  on  your  board, use it to monitor
  623.  the users during the game run.  Also any  runtime  errors  that  are  not
  624.  trapped will be printed out on the  printer.  This  game  has  almost 500
  625.  hours of continous use and most errors  possible  are  trapped.  But some
  626.  users have a knack of finding even the weakest  link  in  any  program so
  627.  if you experience any repeatable errors and they can  be duplicated, they
  628.  will be fixed upon reporting them to me! 
  629.  
  630.  Place ALL FILES THAT ACCOMPANY THIS ZIP FILE IN THE SAME DOOR # directory!
  631.  Everything that you need to operate this game is included in this ZIP. To 
  632.  print the documentation file on a printer type:
  633.  
  634.  C:>TYPE SUPERIG.DOC > PRN  <RETURN> or  C:>COPY SUPERIG.DOC PRN  <RETURN>
  635.  
  636.  
  637.  To view to screen: C:>TYPE SUPERIG.DOC  (use CTRL-S or CRTL-Q to stop/start)
  638.  
  639.  
  640.  
  641. NOTE: A couple of WildCat! sysops have been having  problems with my  games
  642.  dropping carrier when a user quits the game.  This  is  NOT  a programming 
  643.  problem.  The game forces DTR high on game end to prevent DTR drop on  the
  644.  modem when the program ends.  If your WildCat is still having DTR problems 
  645.  on game ending, try changing your modem delay in the initialization string
  646.  within  makewild.  Changing the S10 register to S10=24 gives more time for
  647.  the board  to reset before the modem thinks a user has dropped carrier.  
  648.  Many modems are quite touchy!   This compiled version of Super Rig! uses a
  649.  patched runtime library so that the DTR line is never touched on game exit.
  650.  
  651.   
  652.  
  653.  
  654.             Thank you for trying Super Rig!   I hope you enjoy it!
  655.                  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.                      Super Rig! (C) 1989 Marvin Davis Page - 9
  671.  
  672.  
  673. Registration Format Update!
  674. ---------------------------
  675.  
  676.      A new scheme is now being  used to  'register'  ALL  game(s) with me.  
  677.  Instead of having your name encoded into the game, a ".KEY" file will now 
  678.  be used and you will be issued an individual "serial number" in which  to 
  679.  place in the same directory as the door game.  This  key file will be  in 
  680.  ASCII format and contain your name (or BBS name if you so wish) and  your 
  681.  individualized serial number for registration  identification/validation.  
  682.  
  683.  Every time the game is invoked, the current directory will be polled  for
  684.  its "key" file and if found will be automatically read in by the  program
  685.  and your registered name and serial number will be validated and the game
  686.  then be unlocked and registered automatically!   
  687.  
  688.  V4.0 and above registration update!
  689.  -----------------------------------
  690.  If you are a prior registered user of any Late-Nite door, you can take the
  691.  information in a game .KEY file (ie registered name and serial #) and now
  692.  enter this into the GAME.CFG file via an ASCII editor or SETUP.EXE.  You
  693.  will no longer need the .KEY file system as you now have your registration
  694.  information as to the registered name and serial number.  This will skip
  695.  the test for a .key file in the current directory.  Either methods, will
  696.  function to register your door and display the registration information.
  697.  
  698.  NOTE:
  699.  -----
  700.  If you wish to only register a version of a Late-Nite door game that  you 
  701.  currently have, then you will NOT require me to send you a disk with  the 
  702.  game on it UNLESS you wish to obtain other games (evaulation copies) or a 
  703.  current release of a game (if one is available) you are presently running
  704.  you then ONLY need send $10.00 US for your "Key" file info to immediately 
  705.  register your game.  This can be supplied in EMAIL from me on my BBS!!
  706.  
  707.  Upon receipt of your registration amount, I can make available the  "KEY"
  708.  file for you to download from my (Late-Nite) BBS and you can  then  place 
  709.  this key file in the current game directory and immediately register  the 
  710.  game without waiting for the mail to run!  We're talking maybe  a  two or 
  711.  three minute call to accomplish this.
  712.  
  713.  -> If you have registered a previous release from me and wish to update to
  714.  the new registration format (ie key file) you can write me for your serial
  715.  number and create the file yourself with any ASCII editor or just use  the
  716.  COPY CON (console) DOS command to quickly enter the file directly  into  a 
  717.  DOS ASCII file!  Or, you can call Late-Nite BBS and request the info in an
  718.  E-mail msg to me ([F]eedback to Sysop).
  719.  
  720.  
  721. SysOps of Honesty and Integrity!
  722. --------------------------------
  723.  To the SysOps who have registered my doors on your BBS, I wish to express 
  724.  my sincere THANKS for your integrity and devotion to the 'True Spirit' of 
  725.  Shareware.  It has encouraged me to begin writing more doors...
  726.  
  727.  
  728.  Starvin' Marv's Late-Nite BBS, Sanford NC  340 Megs w/3500+ files online.
  729.   Node-1  (919) 776-2368  14400/9600/4800/2400  HST Dual Std.   (24 hrs)
  730.   Node-2  (919) 775-4477   2400/1200/300        USR Courier MNP (24 hrs)
  731.  
  732.  
  733.                      Super Rig! (C)opyright 1989-91,  Page 10
  734.  
  735.                                T R O U B L E !?
  736.                               -=-=-=-=-=-=-=-=-
  737.  
  738. Having trouble in a door game or its setup?
  739.  
  740. REGISTERED users get highest priority for assistance in game setup or
  741. upgrade information and/or ANY other support possible for using all of
  742. Late-Nite Doorware games.
  743.  
  744. UNREGISTERED users should not "expect" any author to drop everything and
  745. pull out the stops to help them.  I have assisted at length, many Sysop's 
  746. who say "if I help them they will register the game with me...", and I 
  747. :dread: to hear this as it seems to be a CURSE as 98% of those who've said 
  748. this never do.  EVEN after problems are resolved and the game is running
  749. on their systems....  
  750.  
  751. So here are some quidelines to follow in the event you have a problem in a 
  752. door game and need to communicate them to me or any author so they can be 
  753. solved or resolved.  All references to the file GAME.CFG mean the doorgame 
  754. configuration files (ie- SUPERIG.CFG, DCASTLE.CFG, or CIVILWAR.CFG, etc.)
  755.  
  756.  (1)  What is the Doorgame's name and version number you're using? 
  757.  
  758.  (2)  What is the BBS or DoorMenu program's name and version number?
  759.  
  760.  (3)  What is the type of modem and name brand you are using?
  761.  
  762.  (4)  What is the COM PORT used and MODEM's initialization string??
  763.  
  764.  (5)  Is the game envoked in a SHELL (child process) or is the BBS program 
  765.       terminated and the game run from a batchfile?  Large BBS programs 
  766.       (300k+) and large doorgames (100k+) may cause RAM cram and not work 
  767.       correctly or may cause unpredictable erratic operation.
  768.  
  769.  (6)  What is the exact nature of your problem?  
  770.  
  771.       Below are some questions that might help isolate and determine the 
  772.       cause or causes of the game working incorrectly;
  773.  
  774.       a. Game doesn't have correct caller information?
  775.          
  776.          (1) If true then include an actual COPY of the caller info
  777.              file produced by the BBS program you're using and what
  778.              information is it that is not being passed correctly.
  779.    
  780.       b. Game runs but doesn't accept input from Remote Keyboard and
  781.          caller drops carrier to exit?
  782.          
  783.          (1) SEE WILDCAT/LiveCat notes, item #7.
  784.   
  785.       c. Can't get game to even startup up from batchfile.
  786.   
  787.          (1) Is proper command line written in batchfile?  Refer to game 
  788.              doc's for proper "/switch" setting in calling batchfile to 
  789.              startup game.
  790.          (2) Is game setup in its own DIRECTORY?  Do not mix games all in
  791.              a common directory or files will overwrite other files by the 
  792.              same filenames producing a big mess.
  793.   
  794.                                      (A-1) 
  795.  
  796.  
  797.           (3) If inquiring about this problem, please include a COPY of your 
  798.              calling batchfile to envoke the game, and a COPY of the game
  799.              configuration (GAME.CFG) file.       
  800.  
  801.       d. Don't know how to setup LOCKED port for HST type modems.
  802.  
  803.          (1) RUN SETUP that comes with the game and answer the questions
  804.              concerning LOCKED port.  All games can be set to IGNORE the
  805.              DCE (modems baud rate) and force the game to open the COM
  806.              PORT at a fixed DTE (PORT's baud rate) of 9600-38400 baud
  807.              and toggle hardware handshaking on automatically.  Line #7
  808.              in the "GAME.CFG" file might look like this for various
  809.              LOCKED DTE baud rate settings;
  810.  
  811.              LOCKED 19200 RTS/CTS    or    LOCKED 38400 RTS/CTS
  812.  
  813.              This is done for you when using SETUP.
  814.  
  815.       e. Game runs fine but when game is done and user returns back to
  816.          the BBS, the modem looses carrier.
  817.  
  818.         (1) This one can have several reasons why this occurs.  One of the
  819.             reasons is some modems are extremely sensitive to the DTR line
  820.             (Data Terminal Ready) being toggled opening-closing a COM port.
  821.             If you have an internal modem, you will not be able to SEE the 
  822.             DTR light (LED) on the control panel, if this is the case.  
  823.             If you have an external modem closely watch the DTR lamp and see 
  824.             if you can see it blink when the game exits.  You should not be 
  825.             able to see this as when games are terminated and the COM port 
  826.             closed, the very next thing that is done is the DTR line on the 
  827.             COM port is forced HIGH to prevent the modem from dropping its 
  828.             carrier.  This is done very quickly so as not to cause the modem 
  829.             to sense it and drop carrier.  
  830.  
  831.             ALL the Hayes compatible modems I've worked with, do DROP its
  832.             carrier if the DTR line is toggled (unless the DIP switch has
  833.             the DTR forced high) for more than a few milli-sec's ,which is 
  834.             not long.  Some modems have an S register that can adust its 
  835.             sensitivity or actual time to drop carrier upon sensing the DTR 
  836.             line being lowered.
  837.  
  838.             On some machines, if you have originally opened a PORT for
  839.             hardware handshaking (RTS/CTS) and do a SHELL to a process
  840.             that reopens the PORT for NON-hardware handshaking and the
  841.             port is closed - it might drop the DTR line and you loose
  842.             carrier.  If this is the case, you can use (In GAME.CFG) the 
  843.             "RTS/CTS"  (without quotes) on line #7 in place of N/A on
  844.             LOCKED PORT configurations to tell the game to open the COM
  845.             port for hardware handshaking instead of the default of NO
  846.             hardware handshake.  Some cheap brands of internal modems do 
  847.             NOT support hardware handshaking and will not work right if 
  848.             this is hardware mode is required to be done.
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                      (A-2 
  855.  
  856.  
  857.  
  858.             If while observing the TR lamp on your modem, and it does not
  859.             blink and the modem's CARRIER DETECT lamp (CD) remains on until
  860.             the BBS software recycles and re-opens the COM port then there
  861.             is some incompatibility there.  Observe the status of the RS and 
  862.             CS lamps - prior to running the game and their status upon then
  863.             returning from the game.  If they are BOTH on prior to the game
  864.             then the modem has been opened for hardware handshaking and
  865.             you might see the RS light go out during the game run. If when
  866.             exiting back to the BBS the carrier is lost when the modem is
  867.             re-opened and the RS light comes back on and CD goes out then
  868.             it is a port initialization problem and you may have a special
  869.             driver (FOSSIL) or some conflicts with this which may be 
  870.             resolved by forcing the game to open its port with hardware 
  871.             handshake mentioned above in the GAME.CFG file.
  872.  
  873.             No special things are done with the COM port as everything is
  874.             done through QuickBASIC and your BIOS.  But there is always 
  875.             room for compatibility problems to occur and or your particular
  876.             BBS has some special requirements for its port initialization.
  877.  
  878.  (7) WILDCAT BBS's using LiveCat door handler.
  879.  
  880.      a.  I've had the most problems to date with this particular BBS
  881.          software.  Initially I discovered with folks using US Robotics
  882.          HST modems that all my games were "locking up" when they were
  883.          first envoked from the remote modem.  No keyboard input was
  884.          being recognized from the remote modem so it "appeared" that
  885.          the game had locked up, but in fact could be played as normal
  886.          from the local keyboard.  Problem; modem initialization string.
  887.          The game opens the COM port using BASIC's default configuration
  888.          using NO hardware handshake - as none was required to use the
  889.          game in speeds lower than 4800 baud (all speeds 4800 and above 
  890.          use hardware handshake port configurations).  Seems the default
  891.          initialization string for HST using "&R2" in the string forces the 
  892.          modem to IGNORE all remote input while RS is low, so unless the
  893.          port is opened for hardware handshake (RTS/CTS) the computers
  894.          serial port never see's any input!  To correct this simply change
  895.          the "&R2" to "&R1" (HST's default setting!) and the game will
  896.          work fine or ADD the "RTS/CTS" on line #7 of the GAME.CFG and
  897.          the game will open the COM port under hardware handshake on all
  898.          modem speeds.  
  899.  
  900.  (8) Multi-Tasking support under DESQview!
  901.     
  902.      a.  DESQview awareness is not built into the games as yet and some
  903.          systems that cannot do virtual screens may have problems with
  904.          screens bleeding.  According to QuarterDeck, they have a loader
  905.          that can be used to load the game and shadow the screen to stop
  906.          this effect.  Its called QB45LOAD.COM and is available on most
  907.          BBS's.  Future upgrades of the games will include support for
  908.          DESQview and BIOS screen writes (which will be slower!) and that
  909.          will correct that problem.  Under DESQview-386 this is not a
  910.          problem as you can set the window to call the game under to
  911.          YES to DIRECT screen writes and virtualize the <T>est screens
  912.          as all screens are in text mode, not graphics.
  913.  
  914.   
  915.                                      (A-3)
  916.  
  917.  
  918.  
  919. Super Rig! and ANSI terminal compatibility
  920. ------------------------------------------
  921.  
  922.  ANSI terminals and Extended Graphics compatibility graphic problems 
  923.  with different terminal software is not unique.  
  924.  
  925.  I have had comments from users on the Main title screen, where the truck 
  926.  is not displayed right, and on the TruckStop screen where the gas pumps 
  927.  are not displayed right either.
  928.  
  929.  
  930.  Ok, the truck screen and the truck stop are stored in the current game
  931.  directory under the names TITLE.SCR and TRUKSTOP.SCR.  These files can
  932.  be TYPE'ed to screen with (MS-DOS 3.x - 4.01) ANSI.SYS driver installed 
  933.  in the CONFIG.SYS of the machine in question.  Some video boards that 
  934.  include ANSI drivers (such as Orchid's EANSI.SYS) and others, will not 
  935.  display EXTENDED ANSI GRAPHICS SETS correctly!
  936.  
  937.  
  938.  You can look at these files anytime by entering this on the command line;
  939.   
  940.  TYPE TITLE.SCR  (return)  ;sitting in the game directory.
  941.  
  942.  When these or any other .SCR files are transmitted, they are read in
  943.  from their respective disk files and transmitted directly to the COM
  944.  port.  As the ANSI file is being transmitted it is displayed locally
  945.  through an 'internal' ANSI file reader and displayed on the users
  946.  local video screen.
  947.  
  948.  MANY terminals that claim to be able to display ANSI graphics are only
  949.  partially correct (ie. VT-100 emulators).  Currently, I know of (3) 
  950.  terminal programs that WILL display the  -extended-  ANSI/ASCII graphics 
  951.  sets correctly.  
  952.  
  953.  
  954. They are these;
  955.  
  956.  
  957.      PROCOMM 2.4.2 (and v2.4.3)
  958.      PCPLUS v1.1b
  959.      Qmodem v4.x
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.                              Appendix B - page B1
  977.  
  978.  
  979. Testing a terminal program
  980. ==========================
  981.  
  982.  If you have a 'question' of the ANSI/ASCII compatibility of a terminal
  983.  program you can do the following short test!
  984.  
  985. [1] In the terminal in question; make sure its setup that XON/XOFF flow 
  986.     control is turned OFF!
  987.  
  988. [2] Use the terminals ASCII (download transfer menu) Protocol to capture
  989.     what comes in over the COM port into a disk file.  You can hit the 
  990.     particular key to envoke this immediately PRIOR to starting the game 
  991.     up so that when the game begins, it writes to disk the data that is 
  992.     coming in over the COM port.
  993.  
  994.     As soon as a screen is completed, you can END the ASCII transfer
  995.     to disk (in Qmodem and PCPLUS its hitting ESC.)  You have now
  996.     'photographed', so to speak - the incoming file to disk.
  997.  
  998.     Now that you have the "transmitted" file on disk, you can SHELL
  999.     out to DOS and TYPE it to screen.  It should be identical to the
  1000.     file that is on the HOST (transmitting computer) in all respects
  1001.     from DOS.  It might also contain prompts and other characters that
  1002.     are sent immediately prior, or immediately after the ANSI screen
  1003.     in question - but you can 'see' if the basic color screen was sent
  1004.     correctly.
  1005.    
  1006.     Screen 'capture' modes and screen scroll back buffers DO NOT WORK
  1007.     in attempts to re-read ANSI screens, as ANSI control codes are not
  1008.     stored on the screen, they are cursor and color positioning screen
  1009.     commands.
  1010.  
  1011.     This will prove whether the file was transferred un-altered to the 
  1012.     remote machine and that the REMOTE terminal is/is not 'translating' 
  1013.     the incoming file correctly.  There is a lot of them that will NOT 
  1014.     handle the 'extended' character sets (outside normal text/graphics).
  1015.  
  1016.  
  1017. If you were to try using the above mentioned terminals - you should be
  1018. able to see the difference as well.
  1019.  
  1020. I know this to be a problem, as I have experienced this first hand in
  1021. the creation of these games and the different complaints from my local
  1022. users on 'scrambled' or display problems on ANSI graphics.  So, all
  1023. games are tested via the "DOS" and "capture" method, and in using the
  1024. above programs to 'view' the games via remote modem. 
  1025.  
  1026. I hope that these notes will give SysOps some info and direction there 
  1027. concerning display problems on remote terminals.  Note also, there might
  1028. may be an ocassional 'drop-out' bit transmit problem (at hi-speeds) on 
  1029. terminals that rely on BIOS com port polling for the serial ports.  
  1030. Changing to a buffered 16550an UART on the serial cards will fix that, in 
  1031. addition to setting RTS/CTS hardware handshaking on the remotes modem - 
  1032. to prevent buffer overruns and bits being dropped, inducing hardware 
  1033. transmission errors.
  1034.  
  1035. - Marv'-
  1036.  
  1037.                               Appendix B, page B2
  1038.  
  1039.  
  1040.                             ------------------------
  1041.                                    Super Rig!  
  1042.                                Release Ver. 4.01k
  1043.                              Easy Registration Form!
  1044.                             ------------------------
  1045.  
  1046. Mail to:  Marvin Davis
  1047.           Late-Nite BBS
  1048.           313 Queens Road
  1049.           Sanford, NC 27330
  1050.  
  1051.  
  1052.  
  1053.      Your Name_______________________________________________________
  1054.  
  1055. Street Address_______________________________________________________
  1056.  
  1057.           City_______________________________________________________
  1058.  
  1059.     State, Zip_______________________________________________________
  1060.  
  1061.    Home Phone#_______________________________________________________
  1062.  
  1063.       BBS Name_______________________________________________________
  1064.  
  1065.      BBS Hours____________________ /Baud Rate________________________
  1066.  
  1067.     BBS Phone#_______________________________________________________
  1068.  
  1069.   BBS Software_______________________________________________________
  1070.  
  1071.  
  1072.   Disk Format (Check one)    5 1/4 (360k) _____    3 1/2 (720k) _____ 
  1073.  
  1074.   SINGLE NODE Registration _______     Multi-Node Registration ______
  1075.  
  1076.  
  1077.  Please do not send personal checks, send Bank draft/money order, Postal
  1078.  money order or $13.00 US currency.  Personal check may cause a 1-3 week
  1079.  delay in processing.  THANK YOU for registering this Doorware!  It will 
  1080.  encourage me to write more doors in the future.  
  1081.  
  1082.  IF you are registering the game for a MULTI-NODE BBS then send 15.00.
  1083.  
  1084.  NOTE:
  1085.  -----
  1086.  If you wish ONLY a "KEY" to unlock the game and do not need or wish other 
  1087.  evaulation copies of Late-Nite doors then send only $10.00 US and your KEY 
  1088.  info to unlock the game will be mailed to you, or call Late-Nite BBS and 
  1089.  request this info in Email for a quick immediate registration!
  1090.  
  1091.  Also try these Late-Nite Doorware games - Dark Castle, and The Civil WAR!
  1092.  
  1093.  Starvin' Marv's Late-Nite BBS, Sanford NC  340 Megs w/3500+ files online.
  1094.   Node-1  (919) 776-2368  14400/9600/4800/2400  HST Dual Std.   (24 hrs)
  1095.   Node-2  (919) 775-4477   2400/1200/300        USR Courier MNP (24 hrs)
  1096.  
  1097.   
  1098.                            Appendix C - Page C1
  1099.  
  1100.